home *** CD-ROM | disk | FTP | other *** search
/ Experimental BBS Explossion 3 / Experimental BBS Explossion III.iso / gus / p669v105.zip / P669.DOC next >
Text File  |  1980-01-03  |  7KB  |  173 lines
  1. -----------------
  2. PLAY669.DOC   v1.05             Written By Vectorman
  3. -----------------
  4.  
  5. DOC File created on : June 21/93
  6. Last Updated        : July  1/93
  7.  
  8.  
  9.    Well, here is a little hack of a 669 Player...  This one will(should) play
  10. all 669 files(even ones with samples over 64K) but it does not play them
  11. the same was as the P669GU0 program.  I don't know why, but i must have
  12. something different or the way it shouldn't be... Anyways, this one is
  13. virtually UltraCLICK free, and any pops that occur are probably just
  14. sample pops...  It does not check memory, so if it goes over range, that's
  15. tough luck, you won't have any sfx playing there!
  16.    This program uses the onboard-GUS timer, so it works fine under DESQview.
  17. For some reason, i have found that at times there is absolutely no music output,
  18. so if this happens, rerun the program again (this might be gone by the time you
  19. read this).  The reason for this is i guess bad IRQ setup or something on my
  20. part.  This is not a problem with the mixer port.
  21. If you don't have the ULTRASND environment set, the program will return an
  22. error. Instead of using a seperate config program, it's a lot easier to just
  23. read the GF1 IRQ and base port from the settings. Run SETGUS if you don't have
  24. this set.
  25.  
  26.  
  27. Thanks
  28. --------
  29.    -  Gravis - Thanks for releasing the FREE GUSSDK
  30.    -  Tran of Renaissance = for including the 669.DOC file which explains some
  31.       of the 669 format
  32.    -  Stealth Ninja for giving me 15 .669 files so i wouldn't have to d/l them
  33.       from bbs's:)
  34.    -  C.C.Catch = Awesome .669 files! The best i've heard yet!
  35.  
  36.  
  37. Keys
  38. --------
  39.  
  40.    +/-        Changes the volume
  41.    ESC/ENTER  Quits program
  42.    1..8       Turn off the channel associated with the key (Shows Off if off)
  43.    SPACE      Increment the "VU Meter" character, default is 254 dec or 0FEh
  44.    D          Restore original VU Character (254)
  45.    F1         Load Setup (P669.CFG)  See Setup Section
  46.    F2         Save Setup (P669.CFG)  See Setup Section
  47.    Up/Down    Increment/Decrement pattern, bar shows you position.
  48.    TAB        Switches between Grapx/Text (Spectrum/Info Mode)
  49.    H          Toggles the HEX Dump on/off
  50.  
  51.  
  52. Info
  53. --------
  54. This program is mostly written in ASSEMBLER (all the gus routines, and playing
  55. interrupts as well as most of the setup) and the only part done in Turbo Pascal
  56. is basically the actual loading routine... I'll probably convert it to asm
  57. if I find a need for it!  Anybody interested in the source - lemme know! I'm
  58. always ready to xchange code...  It's pretty small for all the features and
  59. stuff included with it.
  60.  
  61.  
  62. Setup
  63. --------
  64. The P669.CFG file stores the following information :
  65. 1) Hex Dump screen on/off
  66. 2) VU Character
  67. 3) Channel Status - On/Off
  68. 4) Volume
  69. The setup file is loaded during startup.  If it does not exist, the program
  70. will load in the default setup, but if it exists it will read the options from
  71. it and set everything up accordingly.
  72.  
  73.  
  74. Changes since version 1.00
  75. --------
  76.    -  Proper playing of 669 files now  (no scrambled stuff coming out)
  77.    -  Balancing set properly (4 and 12 respectively)
  78.    -  Correctly plays to the end of the song, then loops
  79.    -  Added "sentence" errors, not just Error Code # type of thing
  80.  
  81. Changes since version 1.01
  82. --------
  83.    -  Set the speed to that closer to P669GU0.    
  84.  
  85. Changes since version 1.02
  86. --------
  87.    -  Properly starts playing at "LOOPORD" after looping, not during
  88.       music start like before
  89.  
  90. Changes since version 1.03
  91. -------
  92.    -  Uses different technique to control pops.. a little better
  93.    -  Properly turns off GUS during setup (No noise coming out:))
  94.    -  Will play files > 64 Patterns and > 40 Samples
  95.    -  Added some new keys (Check above)
  96.    -  Cut down size of EXE by 2K(whoopee!:)
  97.    -  Did some little changes to the init, now displays at the right time
  98.  
  99. Changes since version 1.04
  100. -------
  101.    - Fixed SongLength bug.  I didn't reset the Songlength variable, therefore
  102.      at certain times it might have contained the incorrect value <WHOOPS!>
  103.    - Added some color for a change!
  104.    - Added new Key - "D"
  105.    - Do checking to make sure that keys such as Space Bar, #255 and #0 are not
  106.      selected when changing default VU char
  107.    - Adding Saving/Loading of P669.CFG file...  This file saves all the info,
  108.      such as: VU Meter Character, Channel Status (On/Off) as well as the
  109.      Volume. Delete the P669.CFG file to load up the default settings.  There
  110.      isn't much checking done, so if there is no space the file will not be
  111.      saved, but 50 BYTES aren't all that much(some bytes are reserved for
  112.      future use, such as : MODE (Spectrum or Bars), Default file name, etc...
  113.    - Added the "Song" message at the top of the screen
  114.    - Implemented the Volume Amount Bar.  This shows you how high the volume
  115.      is(1..10, but volumes are really from 0..100)
  116.    - Included a different volume table... Hopefully this one will be better.
  117.    - If you set the volume to 0, all playing will be set to 0 (Including looping
  118.      samples)
  119.    - Added Incrementing/Decrementing of patterns.
  120.    - Added "Pattern Bar", shows you PROGRESS from 1..10.
  121.    - Graphical Spectrum is included now.. Runs in Standard(ALMOST!) Mode 13h.
  122.      There isn't anything "NEW" in this, no scrolling or anything, just PLAIN
  123.      ugly white dots:)  The channels are from Left to right, Up to Down.
  124.    - Added the Hex Dump feature... This basically dumps all the bytes from
  125.      the current pattern to the screen.  a "--" means that a 0ffh is in that
  126.      position(this makes it easier to see the notes...)  There is no bit reorder
  127.      for now, so it's not displayed in the COMPOSER format.
  128.    - Added the "Sample name", shows the string next to the spectrum for
  129.      the channel.
  130.    - Included the help box.. might [help:)] out a lot!
  131.    - INCREASED the size of the EXE file with all these options by let's see..
  132.      2K!  It's actually about 3K without PKLITING it!
  133.  
  134.    Wheew!  So many options in a couple of hours.. think i'm gonna be sick!
  135.  
  136.  
  137. Bugs
  138. --------
  139.   - I have found that for some reason the .669 file "TECHNOCA.669" plays
  140.     way too fast with P669.  I tried fixing this, but no luck so far!
  141.  
  142. Future Plans
  143. --------
  144.     I think this is the last release version, BUT i might release another
  145.     version if i find any bugs...
  146.  
  147.     You can contact me on any Gravis nodes.
  148.     If you do, use my real name(Adam Kolodziejczak).
  149.  
  150.  
  151. I'll probably include this inside my SOON-TO-BE-RELEASED MOD Player, so you will
  152. be able to listen to .669 and mod's from one program...  The mod player has all
  153. the goodies such as : Fully window oriented interface, Graphical Analyzer,
  154. CLICK and POP free playing, runs in 50 line mode, etc...
  155.  
  156.       L8r                           Vectorman '93
  157.                                     (Adam Kolodziejczak)
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.